home *** CD-ROM | disk | FTP | other *** search
/ Mac Expert 1995 Winter / Mac Expert - Winter 95.iso / Les fichiers / Communications / Internet / Dave 1.0 ƒ / Dave 1.0 README, damnit! < prev    next >
Encoding:
Text File  |  1995-04-09  |  6.6 KB  |  167 lines  |  [TEXT/ttxt]
  1. <HTML>
  2. <HEAD>
  3. <TITLE>Dave: The PageMaker to HTML conversion utility</TITLE>
  4. <H1>Dave </H1>
  5. </HEAD>
  6. <BODY>
  7. <H2> The PageMaker to HTML conversion utility</H2>
  8.  
  9. <h1>News!</h1>
  10.  
  11. Work on a non-AppleScript version of Dave has begun. Please try out 1.0 and let
  12. me know what you like and don't like. What would be your ideal PageMaker -> HTML
  13. converter? The new Dave promises to faster, easier to use, and have more
  14. features, so check back here soon for more news!
  15. <P>
  16.  
  17. Copyright © 1994-5 <a href="http://www.bucknell.edu/~boulter">Jeff
  18. Boulter</a> and <a
  19. href="http://www.bucknell.edu/bucknellian"><I>The Bucknellian</I></a>
  20. <P>
  21. <H3>Current Version: <B> 1.0 </B></H3>
  22.  
  23. The latest version of this document and Dave can always be found at <a
  24. href="http://www.bucknell.edu/bucknellian/dave">http://www.bucknell.edu/bucknellian/dave</a>.
  25. <P>
  26.  
  27. <H3>Changes since the last version: (1.0b6)</H3>
  28. <UL>
  29. <LI>More "user friendly"
  30. <LI>Better character translation
  31. <LI>Easily customizable
  32. <LI>Now an AppleScript Application
  33. <LI>Faster!
  34. </UL>
  35.  
  36.  
  37. <H3>Changes since the first version:</H3>
  38. <UL>
  39. <LI>Now strips off the quotation marks around the stories
  40. <LI>Various cosmetic changes in HTML code
  41. <LI> No longer 'eats' paragraphs (I think!)
  42. </UL>
  43. <P>
  44. <H2>Introduction to Dave </H2>
  45. Dave is an AppleScript script (<STRONG>not</STRONG> a regular Macintosh
  46. application) that works with PageMaker 5.0 to extract 
  47. articles and convert them to HTML.
  48. <P>
  49. Dave is free. Use it, love it, hack it.
  50. <P>
  51. <P>
  52. <H2>System Requirements</H2>
  53. <UL>
  54. <LI>Any Macintosh that can run AppleScript
  55. <LI>AppleScript 1.1
  56. <LI>PageMaker 5.0 (not really needed, but it is the point of the whole thing)
  57. <LI>The File IO OSAX from <A
  58. HREF="ftp://ftp.bucknell.edu/pub/bucknellian/script-tools-131-as.hqx">Script
  59. Tools by Mark Aldritt</a>
  60. </UL>
  61. <P>
  62. I DO NOT KNOW A PAGEMAKER -> HTML CONVERTER FOR THE PC, UNIX, etc (at least for PageMaker.) I have no intention of porting dave to these platforms in the future.
  63. There is a list of other<A
  64. HREF="http://info.cern.ch/hypertext/WWW/Tools/Word_proc_filters.html">other 
  65. conversion packages</A> that create HTML from Quark Xpress, Word, etc. I know of
  66. no similar program for PCs.
  67. <P>
  68. <H2>How to use Dave </H2>
  69. <P>
  70.  
  71. <OL>
  72.     <LI> Make sure that the File IO Addition is in your Scripting Additions folder in
  73. your Extensions Folder in your System Folder. (whew!) File IO is the only extra addition that you will need.
  74.     <LI> Open Dave with the AppleScript Script Editor.
  75.     <LI> Change the email address and possibly other HTML formatting to suit your
  76. needs.
  77.     If your <B>HTML</B> is shaky, see <A
  78. HREF="http://www.ncsa.uiuc.edu/General/Internet/WWW/HTMLPrimer.html">
  79.     A Beginner's Guide to HTML</A>. Some good <A
  80. HREF="http://mmm.dartmouth.edu/pages/macscripting/macscripting-home.html">
  81.     <B>AppleScript</B> information</A> is available courtesy of the <A
  82. HREF="http://mmm.dartmouth.edu/pages/macscripting/macscripting-home.html">Macintosh
  83. Scripting List</A>.
  84.     <LI> Quit the Script Editor, making sure to save your changes.
  85.     <LI> Put Dave in the Apple Menu Items folder of your System Folder
  86.     <LI> Open the PageMaker document you wish to convert.
  87.     <LI> Click (with the arrow tool) a story in PageMaker 5.0.
  88.     <LI> Select Dave from your Apple Menu.
  89.     <LI> The first time you run Dave, it (he?) will ask you "Where is PageMaker 5.0?" Just navigate through the dialog until you find your copy of PageMaker 5.0 on your hard drive, select it, and hit OK.
  90.     <LI> Dave will ask you for an article title, and then a sub title for that
  91. story. 
  92.     <LI> Automagically, the text is converted to HTML and linked to in the
  93. index.html file on your desktop. It's rather cool. 
  94. </OL>
  95. <P>
  96. <H2>Things you should know about Dave</H2>
  97. <P>
  98. Included in the Dave package is a "souped-up" version of Dave that we use to
  99. create <a
  100. HREF="http://www.bucknell.edu/bucknellian"><I>The Online Bucknellian</I></A> each week.
  101. If you want the ability to do sections or more advanced HTML formatting, take a look at it.
  102. <P>
  103.  
  104. Since AppleScript uses the Macintosh built-in text buffer, articles have to be
  105. somewhat less than 32K in size.<P>
  106.  
  107. I make a broad assumption that any paragraph less than 25 characters long and
  108. greater than 5 characters long is a subhead and is formatted differently. Change
  109. this if it bothers you.
  110. <P>
  111. Dave figures out what section a particular article is in by looking at the title
  112. of the PageMaker document. At <A
  113. href="http://www.bucknell.edu/bucknellian"><I>The Bucknellian</I></a>, our
  114. masters are called News Master, Ops Master, etc and Dave uses this to determine the particular section of an article.
  115. <P>
  116. My name is <B>not</B> Dave. It's Jeff. (See later section titled <I>"Isn't Dave a stupid
  117. name?"</I>)
  118. <P>
  119. <H2>Dave's hangups</H2>
  120. <P>
  121. <UL>
  122. <LI>Gee, it could be faster, couldn't it?
  123. <LI>Cannot do multiple character replaces: e.g. It cannot replace the ASCII
  124. equivalent of ellipsis with three periods (...) This is due to the fact that it
  125. makes changes out to disk. AppleScript does not allow editing of strings as far
  126. as I can tell.
  127. </UL>
  128.  
  129. If you have any suggestions for improving Dave, 
  130. <a href="mailto:boulter@bucknell.edu">mail me, Jeff Boulter
  131. <boulter@bucknell.edu></a>. Now is an especially good time to give me suggestions as
  132. Dave is being completely rewritten in C++ with more features and generally cooler stuff.<P>
  133. <P>
  134. <H2>Still interested?</H2>
  135. <P>
  136. <a href="ftp://ftp.bucknell.edu/pub/bucknellian/dave.cpt.hqx">Pick up a copy of
  137. Dave!</a><P>
  138. Make sure you pick up a copy of <a
  139. href="ftp://ftp.bucknell.edu/pub/bucknellian/script-tools-131-as.hqx">Script
  140. Tools by Mark Aldritt</a> as well and put a copy of the File IO Addition in the Scripting
  141. Additions folder of your Extensions folder.<P>
  142. <P>
  143. Go ahead, <a href="ftp://ftp.bucknell.edu/pub/bucknellian/dave.cpt.hqx">take another.</a>
  144. Dave is completely free. However, <A HREF="http://www.bucknell.edu/~boulter/">I</A>
  145.  am not responsible for any damage or loss of data whatsoever caused by Dave, 
  146.  including lost files, fires, and ozone depletion.
  147. <P>
  148. <H2>Isn't Dave a really dumb name?</H2>
  149. <P>
  150. No. You got something against Daves? Dave (the program) is named after 
  151. <a href="http://www.bucknell.edu/~dmaher">Dave (the guy)</a> who has been 
  152. creating <a href="http://www.bucknell.edu/bucknellian"><I>The 
  153. Online Bucknellian</I></a> since the days when we cut and pasted into 
  154. templates. (cold shivers). <P>
  155.  
  156. Hopefully, one day, Dave (the program) will replace <a 
  157. href="http://www.bucknell.edu/~dmaher">Dave (the guy)</a> 
  158. and <A HREF="http://www.bucknell.edu/~dmaher">Dave (the guy)</a> can find 
  159. better things to do with his time (like play 
  160. <A HREF="http://www.bucknell.edu/~boulter/risk/">Risk</A> ).
  161.  
  162. <HR>
  163. <ADDRESS><A href="mailto:boulter@bucknell.edu">Jeff Boulter,
  164. boulter@bucknell.edu</A></ADDRESS>
  165. </BODY>
  166. </HTML>
  167.